home *** CD-ROM | disk | FTP | other *** search
/ Best Tools for JAVA / Best Tools for JAVA.iso / CONVERTR / WPT51D10 / README.TXT < prev    next >
Encoding:
Text File  |  1994-06-29  |  9.2 KB  |  187 lines
  1. WPTOHTML 1.00 is a macro which converts WordPerfect 5.1/6.0 for
  2. DOS documents to HTML (now in the public domain).  Unlike many
  3. editing tools, this macro allows individuals with no knowledge
  4. of HTML to create full featured documents in a familiar WYSIWYG
  5. environment.  Many documents created without HTML in mind can be
  6. converted and posted on-line without further alteration. 
  7. Features in this release include:
  8.  
  9. o    Conversion of tables of contents, cross-references(*),
  10.      indices, endnote references, and WordPerfect 6.0 hypertext
  11.      links into HTML hypertext links.
  12.  
  13. o    Automatic conversion of tables created using either the
  14.      "Tab" key or using WordPerfect Table function.
  15.  
  16. o    Support for the full ISOLatin1 character set and some non-
  17.      standard extensions.
  18.  
  19. o    Level n styles, including styles created by the user,
  20.      become level n headings (in 5.1); enlarged and reduced text
  21.      become headings as well.
  22.  
  23. o    Support for in-line figure references, horizontal lines,
  24.      block quotes, shifts to fixed-width (Courier) fonts(*),
  25.      bold-face, italics, underlining, non-breaking spaces, and
  26.      creation of header and address text.
  27.  
  28. o    Automatic conversion to an ASCII text file with an .HTM
  29.      extension.
  30.  
  31. o    An almost single-pass algorithm achieves an acceptable
  32.      speed, despite that fact that the WordPerfect macro
  33.      language is interpreted.
  34.  
  35. (Features marked with a * do not work perfectly or are
  36. unavailable with the 5.1 macro; use the 6.0 macro if possible.)
  37.  
  38. Bug reports and suggestions for improvement are welcome.  If the
  39. response is sufficiently positive, future releases will include
  40. a version for WP6.0 for Windows, as well as an HTML toolbox,
  41. instant format-swapping, execution of hypertext links to remote
  42. URLs from within WordPerfect, importing of HTML, and eventual
  43. support for HTML+.  WordPerfect is a trademark of WordPerfect
  44. Corporation.
  45.  
  46. Hunter Monroe
  47. (hmonroe@imf.org) Documentation for WPTOHTML 1.00
  48.  
  49.      WPTOHTML 1.00 is a macro for converting WordPerfect 5.1/6.0
  50. documents to the HyperText Markup Language (HTML), the format
  51. used by the Internet's World-Wide Web (WWW).  It will convert
  52. documents which were not created with HTML in mind and by
  53. individuals with no knowledge of HTML.  WPTOHTML 1.00 has now
  54. been placed in the public domain.
  55.      System Requirements: The macro will run on any computer with
  56. WordPerfect 5.1/6.0 for DOS (as well as WordPerfect 5.1 for VAX
  57. VMS); a 486 CPU is recommended but not required.  Note that
  58. WordPerfect 6.0 for Windows (WP4W) is not currently supported. 
  59. However, documents created within WP4W can be imported into
  60. WordPerfect 6.0 for DOS and converted using WPTOHTML.  Also not
  61. supported are WordPerfect for the OS/2 and Unix operating
  62. systems.
  63.      Installation: Make sure that you have the correct version
  64. of WPTOHTML for your version of WordPerfect: WPT60DOS.ZIP for
  65. WordPerfect 6.0 for DOS; and WPT51DOS.ZIP for WordPerfect 5.1 for
  66. DOS.  Copy the file WPTOHTML.WPM to your WordPerfect Macro Files
  67. directory, which (probably \WP60\MACROS) for 6.0).  To be
  68. certain, within WordPerfect type Shift-F1, choose Location of
  69. Files, and look under Macros.  Copy the file with the .PRS to
  70. your Printer Files directory (probably \WP51 or \WPC60DOS), which
  71. you can check by typing Shift F1, Location of Files.
  72.      Running WPTOHTML:  To run WPTOHTML, you must first save your
  73. document to disk.  The filename of the WordPerfect should not
  74. have the file extension .HTM.  Then, type Alt-F10, the letters
  75. WPTOHTML, and then hit the enter key.  The macro will move to the
  76. top of your documents, and then pass through it character-by-
  77. character inserting HTML tags as it goes along, such as "<B>" for
  78. boldspace.  When the macro is done, you will be asked if you want
  79. to save the file to disk with the file extension (the three
  80. letters of the filename after the ".") changed to ".HTM".  Choose
  81. yes unless for some reason you do not want to replace a file by
  82. the same name already on disk.
  83.      WPTOHTML gives your the option to save your document when
  84. it is finished.  If you make further changes, be sure to save
  85. your document as ASCII text rather than in WordPerfect format (in
  86. WordPerfect 5.1, use Ctrl-F5, 1).  
  87.      Viewing the Results:  To view the output of WPTOHTML, you
  88. need a World-Wide Web client such as NCSA Mosaic for Windows, or
  89. Cello for Windows.  NCSA Mosaic may obtained by anonymous FTP
  90. from ftp.ncsa.uiuc.edu.
  91.      Publishing your HTML Document On-line:  To place an HTML
  92. document on-line, you need access to a WWW, Gopher, or ftp server
  93. on a computer connected to the Internet.  If you cannot post
  94. information on someone else's server, you can obtain information
  95. about installing your own WWW server from http://info.cern.ch/
  96. or Gopher server from ftp://boombox.micro.umn.edu
  97. You should carefully consider the security implications before
  98. setting up a server on your computer.  If you use the wrong
  99. software or configure it poorly, outsiders can potentially read
  100. and delete any file on your computer.
  101.      Samples: The following are samples of codes which are
  102. converted by WPTOHTML.
  103. BOLD, ITALC, UND, DBL UND, REDLN, 
  104. EXT LARGE, VRY LARGE, LARGE, SMALL, FINE.
  105.      
  106.      Lft/Rgt Indent (this paragraph becomes a block quote
  107.      in HTML.  That means both sides are indented.
  108.  
  109. Horizontal line
  110. Here are some unusual characters:
  111. £ìÅäëèïî
  112.  
  113.      Features Not Supported:  WPTOHMTL does not support all
  114. WordPerfect features, including Equations, Table Boxes, and Text
  115. Boxes.  It does not yet support HTML elements for unordered lists
  116. or ordered lists.
  117.  
  118.      Tips for Achieving Better Results: 
  119.  
  120.      Generated Text: When you define a table of contents, list,
  121. or index, leave off the page number.  
  122.      Styles: In WordPerfect 5.1, any "Outline" type style has
  123. <Hn></Hn> tags added to its codes for level n.  In WordPerfect
  124. 6.0 for DOS, the styles are left unchanged (an earlier version
  125. of WPTOHTML converted any style with a number in it to a header).
  126.      If you have developed your own custom styles, you may wish
  127. to create an HTML version of those styles to override WPTOHTML's
  128. conversion.  Suppose your existing styles are in a file called
  129. LIBRARY.STY, and you have a style called "Main" that should
  130. becomes a first-level heading.  Edit the codes for the "Main"
  131. style, while leaving the name as it is, and replace the existing
  132. codes with "<H1>[Comment]</H1>".  Do the same for your other
  133. styles.  Then, save the HTML version of your styles to a file
  134. called HTML.STY.
  135.      Then, to convert a document to HTML: (1) load LIBRARY.STY,
  136. (2) run WPTOHTML, (3) load HTML.STY, and (4) save the document
  137. as ASCII text.  It is important that LIBRARY.STY is loaded when
  138. you run WPTOHTML, for instance, so a table of contents is
  139. generated correctly.
  140.      Graphics: WPTOHTML does not convert graphics files from
  141. WordPerfect's graphic format, .WPG, to the formats commonly used
  142. on the Internet, such as .GIF or .JPEG.  Graphics Workshop for
  143. Windows will convert the bitmapped portions of a .WPG file, but
  144. not the object-oriented portions (lines and circles), if these
  145. are present.  Suggestions to the author on how best to convert
  146. graphics from .WPG format are welcome.
  147.      Cross-References:  In WordPerfect 6.0 for DOS, cross-
  148. references and targets are converted to HTML links based upon the
  149. name you specify for the target.  However, in WordPerfect 5.1
  150. WPTOHTML uses the names TARGETn.XXX for the nth target or cross-
  151. reference from the top of the document.  Only if your targets and
  152. cross-references happen to come in the same order will they match
  153. properly, so you will need to edit the HTML version to correct
  154. for this problem.  Upgrade to WordPerfect 6.0 if you want to
  155. avoid this problem.
  156.  
  157.      Advanced Features: WPTOHTML converts documents with tables
  158. and endnotes to HTML in a slightly different way than documents
  159. without these features.  The macro prints the HTML version to
  160. disk, and then reopens it for you.  On the other hand, for
  161. documents without tables or endnotes, WPTOHTML normally creates
  162. the HTML version within WordPerfect and asks whether you want to
  163. save it.
  164.      If you want to make changes to a document after running
  165. WPTOHTML, for instance, by loading a style file that you have
  166. created, you need to do the following.  Install the .PRS file
  167. that came with WPTOHTML as a new printer.  Edit that printer to
  168. give it a port of other and set it to print to a file call
  169. WPTOHTML.PRN.  Go to the document screen (using Shift-F3) that
  170. has your document with a mixture of WordPerfect codes and HTML
  171. tags.  Make any changes, such as loading HTML.STY.  Then, print
  172. the document to the file WPTOHTML.PRN by selecting the printer
  173. you just installed.  Open WPTOHTML.PRN, and do a global search-
  174. and-replace to eliminate the form feeds.
  175.      Footnotes and Endnotes: Because HTML is not page-oriented,
  176. you should convert footnotes to endnotes by running the macro
  177. FOOTEND.WPM, which is part of the WordPerfect distribution.  Type
  178. Alt-F10, then FOOTEND, and then hit the Enter key.  Then, after
  179. you run WPTOHTML on a document with endnotes, WPTOHTML will print
  180. to a file rather than saving your file to disk with an .HTM
  181. extension.
  182.      Tables: There are two methods for creating tables in
  183. WordPerfect: using the Tab key, and using the WordPerfect table
  184. function.  If you use the first method, WPTOHTML decides that a
  185. line is part of a table if it has a Tab anywhere after a
  186. character.
  187.